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Chapter 4: IVR 2.0/I call flow interface 


Now that you understand how to script VT 100 transactions as action and 
screen templates, you can begin integrating these templates into your IVR 
2.0/1 Applications (Figure 4-1). 


Figure 4-1 
Accessing the mainframe 
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This chapter explains 


e how to code your applications to perform VT100 transactions 


e how to use the COMI, COMO, and COMA cells to communicate with 
the host computer (using the accounting application developed in the 
previous chapters as an example) 


Using the COMI, COMO, and COMA cells to access the host 


computer 


With IVR 2.0/1, the links between the IVR 2.0/I call flow and the TRS are the 
COM cells. The COMI cell sends input to the TRS process and identifies the 
action template file, the COMO cell receives output from the TRS process, 
and the COMA cell aborts a transaction in progress (usually used in the 
clean-up branch in case a caller hangs up before the transaction completes). 
Figure 4-2 illustrates this interaction. 
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Figure 4-2 
Activating the gateway from a COMI cell 
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To develop an application that processes one or more terminal sessions, start 
as if you were developing any other voice application: 


e Determine the telephone interaction with the caller and create the 
corresponding IVR 2.0/1 call flow. 


e At the point in the call flow where you require interaction with the host 
computer, insert a COMI cell. 


e — Insert a COMO cell to receive the output from the TRS transaction. 
You must always follow a COMI cell with a COMO cell, even if you do not 


require the return of any data. 


Setting the COMI cell parameters 


Figure 4-3 shows the parameter window for the COMI cell in the accounting 
application. 
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Figure 4-3 
COMI cell parameter window 


COMI Parameters 
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The following sections describe what you should enter in each area of the 
parameter window. 


COMI cell name 


In order to make the cell easy to identify, includes the name of the action 
template the cell calls out. The cell name shown in Figure 4-3 is “start 
getbalance transaction.” 


Call Audit Enabled 


Determines if this cell logs the following information to the call audit 
statistics file (audit_stat.d): 


e Application Name 

e Cell Name 

e Cell Number 

e Date and Time of Cell Execution 

e Contents of the Cell Comment field 

e Contents of the Call Audit Information buffer 


The default setting is No. 


Call Audit Information 


When you enable Call Auditing, the Call Auditing process logs the contents 
of this buffer to the audit_stat.d file. The default setting is DIGITS. 


COMI action template 


Enter the name of the action template, in quotes, and leave off the .act suffix. 
Figure 4-3 shows “getbalance” as the entered name. 


COMI cell more input 

If you need to send more than 10 input buffers to the host computer, click the 
button in front of “Yes”; if you are sending 10 or less input buffers, click the 
button in front of “No.” If you specify “Yes,” place additional COMI cells 
on the drawing board until you have enough input buffers. Connect the 
Success branch of the first COMI cell to the Input branch of the following 
COMI cell. Connect the rest of the COMI cells in this fashion. The final 
COMI cell should have the “No” button selected for the “More Input?” 
parameter. 
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COMI cell timeout 


Select the number of seconds you want the TRS process to wait for the 
transaction to complete by moving the slider under “Timeout”. There is an 
available range from | to 75 seconds. This indicates the maximum time for 
the COMI cell to start the transaction and send the necessary input buffers, 
and for the COMO cell to receive the output buffers. The TRS process rejects 
the transaction and sends back a timeout if the action is not performed within 
the time allotted. 


Note: The application will take the timeout branch of the COMI cell if a 
timeout occurs. 


Note: There is an inherent 5 second transaction time for each 
sleep-descriptor input. The total value of the sleep-descriptor and the 
inherent time must not exceed the time out value. For example, with 10 
buffers, the inherent wait time is a minimum of 50 seconds. Therefore, the 
time out value should be greater than 50 seconds. 


COMI cell buffer count 


You do not need to enter a value in this field as IVR 2.0/I automatically 
calculates the number of buffers when you click the “Apply” button. 


COMI cell input buffers 

Enter the names of the input buffers containing the information to pass to the 
TRS process. The input buffer shown in Figure 4-3 is ACCOUNTNUMBER, 
without any quotes. In this example, you must program your application to 
place the customer’s account number in the ACCOUNTNUMBER buffer 
before the COMI cell is executed. 


In this example, ACCOUNTNUMBER is a user-defined buffer; you can use 
any name for your applications, or you can use system buffers. 


Note: You must enter the input buffers in the same order the host computer 
uses them. 


If you need to use more than 10 input buffers in your application, make sure 
you select “Yes” for “More Input?”, then string COMI cells together until you 
have enough input buffers. Connect each additional COMI cell to the 
previous one’s “SUCCESS” branch. 
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Setting the COMO cell parameters 


Once you have set the COMI cell to send information, code the COMO cell 
to receive information. You must place a COMO cell directly after the COMI 
cell to complete the transaction, even if the host computer is not sending any 
data to any output buffers. The TRS process sends verification that the 
transaction completed successfully or it sends notification that there was an 
error in the COMO cell. 


Figure 4-4 shows the parameter window for the COMO cell in the accounting 
application. 
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Figure 4-4 
COMO cell parameter window 


COMO Parameters 





The following sections describe what you should enter in each area of the 
parameter window. 


COMO cell name 


The cell name shown in Figure 4-4 is “Receive Balance.” The name helps 
identify the function of the cell. 
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Call Audit Enabled 


Determines if this cell logs the following information to the call audit 
statistics file (audit_stat.d): 


e Application Name 

e Cell Name 

e — Cell Number 

e Date and Time of Cell Execution 

e Contents of the Cell Comment field 

e Contents of the Call Audit Information buffer 


The default setting is No. 


Call Audit Information 


When you enable Call Auditing, the Call Auditing process logs the contents 
of this buffer to the audit_stat.d file. The default setting is DIGITS. 


COMO cell blocking? 

Activating blocking tells the COMO cell to wait for the transaction to 
complete before continuing to the next cell. The application will wait until the 
TRS interaction ends before it continues through the IVR 2.0/1 application 
(following the “END OF DATA” or “MORE DATA” branch, only one of 
these cells should have a branch). If you select “No,” the COMO cell receives 
a status code from the TRS process. If the transaction is complete, the 
application follows the “END OF DATA” or “MORE DATA” branch 
(whichever one connects to another cell). If the transaction is not complete, 
the application follows the ” NOT READY” branch. You could use this 
branch to play a prompt notifying the caller that the transaction is in progress, 
and then feed the call flow back into the COMO cell. 


COMO cell buffer count 


You do not need to enter a value in this field as IVR 2.0/I automatically 
calculates the number of buffers when you click on the “Apply” button. 


COMO cell output buffers 


Enter the name of the buffers that will accept the output from the host 
computer. Figure 4-4 shows BALANCE (no quotes) as the only output buffer 
for this example. 
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Note: You must enter the output buffers in the same order they will be used 
by the TRS process. 


If your application uses more than 10 output buffers, string COMO cells 
together until you have enough buffers. Connect the input branch of each 
subsequent COMO cells to the “MORE DATA” branch of the previous 
COMO cell. 


COMO cell branches 
As shown in Figure 4-5 on page 4-9, the COMO cell has several branches. 


Figure 4-5 
COMO cell 


MORE 
DATA 





Table 4-1 describes each branch of the COMO cell.1 


Table 4-1 
Branches of the COMO cell 


| Branch | Reason the branch would be taken 
ERROR Any problem with any part the host transaction will 
cause the application to take the error branch. 


TIMEOUT The transaction took more than its allowed time as 
specified in the COMI cell. 

NOT READY The transaction did not complete and Blocking was 
set to “No” 


END OF DATA The transaction successfully completed 
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Table 4-1 
Branches of the COMO cell (continued) 


Reason the branch would be taken 





MORE DATA The transaction requires additional output buffers 


For each COMO cell, use either the “END OF DATA” branch, or the “MORE 
DATA” branch, but not both. If you use the “MORE DATA” branch, the next 
cell must be another COMO cell. The last COMO cell should use the “END 
OF DATA” branch. 


Setting the COMA cell parameters 


Use a COMA cell in the CLEANUP branch of the START cell to deal with 
an error like a caller hanging up in the middle of a transaction. See Figure 4-6. 


If you selected manual mode in the application template, use the COMA cell 
to abort a transaction in progress and release the session (see Chapter 2). 


Figure 4-6 
COMA cell in the CLEANUP branch of a START cell 


(Cher transaction 


aawaall_ | ERROR 


SUCCESS SUCCESS 
; = 





The COMA cell frees all memory and buffers associated with the COMI and 
COMO cells. 


The COMA cell parameters window contains a cell name field, and a 


comments field. The COMA cell in Figure 4-6 has “Clear transaction” as its 
cell name. 
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An application using the COMI, COMO, and COMA cells 


Figure 4-7 shows a sample IVR 2.0/1 application that uses the COMI, COMO, 
and COMA cells to retrieve a customer’s account balance stored on a host 
computer. This example application uses the action and screen templates 
created in Chapter 3. A caller activates this example application by pressing 
“1” after hearing the prompt played by the MENU cell. A separate action 
template and its associated screen templates would need to be created to 
support menu choice 2. 


To illustrate the logic of the call flow, these applications are shown as one 
page applications with no error branches. In reality, these applications would 
span several pages and would have all error branches connected 
appropriately. 
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Figure 4-7 
IVR 2.0/l application accessing the TRS process from the COMI, COMO 
cells 


DÉ Samms 


B mo 





Prior to the execution of this application, the initial-action template is 
executed (when IVR 2.0/1 is started on the application processor). Once a call 
from a customer is received, the IVR 2.0/I application performs these steps: 
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Table 4-2 
Application cell functions 


Cask eee ee 
Cell 1 The ANSW cell answers the incoming call. 


Cell 2 The GDAT cell plays a prompt requesting the caller to 
enter an account number. The number entered is 
stored in the ACCOUNTNUMBER buffer. 

Cell 3 The MENU cell plays a prompt instructing the caller to 
press 1 to get an account balance, or press 2 to get an 
account update. 


Cell 4 When the caller presses “1” on the telephone, the COMI 
cell starts the transaction. 
According to the COMI cell parameters in Figure 4-3, 
the action template specified in the COMI cell 
parameter window is “getbalance’”. (This template is 
used in the sample transaction described in Chapter 3: 
Getting started, specifically Figure 3-11 on page 3-18.) 
The COMI cell provides the contents of the 
ACCOUNTNUMBER buffer to the host computer 
application. 


Cell 5 According to the COMO cell parameters in Figure 4-4 
on page 4-7, the COMO cell receives the customer's 
balance from the BALANCE buffer. 

Cell 6 The contents of the BALANCE buffer is played to the 
user. 


Cell 7-9 When the caller presses “2” on the telephone, an 
account update is given because the application 
communicates in a similar manner. 


Cell 10 The caller hangs up and the application ends. 


If the caller hangs up before the transaction is completed, the COMA cell in 
the clean-up branch of the START cell clears the memory and buffers 
associated with the application. 
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Figure 4-8 on page 4-15 shows how the COMI and COMO cell parameters 

relate to the screens defined on the host computer. This transaction uses an 
action template, getbalance, to call three screen templates - one to choose the 
Accounts Receivable menu, one to enter the account number, and one for the 
customer information screen. Each screen template lists the fields that will 

be accessed. 
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COMI/COMO cell parameters, TRS templates, and VT100 screens 


Templates 


From Action Template parameter in COMI cell 


Corresponding Screens 





#action template to perform steps 
#required to retrieve customer's balance 
#fllename: getbalance.act 














getbalance| acctng clr_cust logout_cust 
accrec #choose Ac. Rec menu 
acctno #enters account number 


customer #retrieves balance 








#screen template to choose accounts 
#receivable option, filename:accrec.scn 


accrec 1,20 ACME Accounting 
24,26 = 1 
0,0 < ENTER 





ACME Accounting 


1 Accounts Receivable 
2 Accounts Payable 

3 Reports 

4 Inventory 

5 Exit 


Enter menu selection: E 








ACME Accounting 


1 Accounts Receivable 
2 Accounts Payable 

3 Reports 

4 Inventory 

5 Exit 


Enter menu selection: 1 


Enter account number: E 








#screen template to enter acct number 
#in popup field, filename: acctno.scn 














acctno 1,11 Enter account number: 
24,11 — i 
0,0 < NTER 





COMI cell 


From ACCOUNTNUMBER buffer in 1845-23-87 


ACME Accounting 


1 Accounts Receivable 
2 Accounts Payable 

3 Reports 

4 Inventory 

5 Exit 


Enter menu selection: 1 











#screen template to obtain balance 
#filename: customer.scn 

customer 1,1 Account Number: 
2,48 — $ 























Put into BALANCE buffer in COMO cell 


Account Number: 845-23-87 

Customer: Jane K. Smith Current Balan 

Address: 19 Alpha Road Paym 
Chelmsford ment Due 


Ce; 


Date: 











150.00 
4/30/93 











Options: 


1 Print invoice 
2 Enter payment 
3 Enter purchase 
4 Exit 


Enter menu selection: E 
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